Inside Macintosh: /

QuickDraw 3D RAVE / QuickDraw 3D RAVE Reference

QuickDraw 3D RAVE Routines / Manipulating Draw Contexts

QADrawVTexture

You can use the QADrawVTexture function to draw texture-mapped objects defined by vertices.

#define QADrawVTexture(drawContext,nVertices,vertexMode,vertices,flags) \
 (drawContext)->drawVTexture(drawContext,nVertices,vertexMode,vertices,flags)

drawContext

A draw context.

nVertices

The number of vertices contained in the vertices array.

vertexMode

A vertex mode. See "Vertex Modes" (page 1-56) for a description of the available vertex modes.

vertices

An array of texture vertices.

flags

An array of triangle flags, or the value NULL. See "Triangle Flags Masks" (page 1-63) for a description of the available triangle flags. This parameter is valid only if the vertexMode parameter contains the value kQAVertexMode_Tri, kQAVertexMode_Strip, or kQAVertexMode_Fan.

DESCRIPTION

The QADrawVTexture function draws the vertices in the array specified by the vertices parameter into the draw context specified by the drawContext parameter, according to the vertex modes flag specified by the vertexMode parameter. For instance, if the value of the vertexMode parameter is kQAVertexMode_Polyline, then the vertices in that array are interpreted as defining a polyline (a set of connected line segments). Texture mapping (using the texture determined by the value of the kQATag_Texture state variable) is applied to whatever objects are drawn.

IMPORTANT

The vertex modes kQAVertexMode_Point and kQAVertexMode_Line are supported only by drawing engines that support the kQAOptional_OpenGL feature. All other drawing engines should ignore requests to texture map points or lines.

SPECIAL CONSIDERATIONS

The QADrawVTexture function is optional and must be supported only by drawing engines that support texture mapping and do not want calls to QADrawVTexture to be replaced by calls to the QADrawPoint, QADrawLine, or QADrawTriTexture methods.